[Summary view] [Print] [Text view]

   1   * SWFUpload Core, January 2009, www.swfupload.org, swfupload.googlecode.com
   2  
   3   * --------- Version 2.2.0.1-----------
   4   * - Removed requeueUpload due to bugs/poor testing
   5   * = Fixed namespace conflict that broke stopUpload
   6   
   7   * --------- Version 2.2.0-----------
   8   * + Added button_placeholder setting that accepts a DOM element.
   9   * + Added ability to requeue any file (including some improvement to internal queue state tracking)
  10   * + UploadErrors caused by a missing upload_url now causes the file to be requeued automatically
  11   * + Added preserve_relative_urls setting
  12   * + SWFUpload now converts relative URLs to absolute URLs to avoid issues with Flash Player interpreting it differently on some clients
  13   * + Added assume_success_timeout setting which allows uploadSuccess to be called after a timeout if, for some reason Flash ignores the server's response
  14   *   An additional parameter has been added to the uploadSuccess event to indicate whether a response was received or success was assumed.
  15   
  16   * --------- Version 2.2.0 Beta 2 ~ 5-----------
  17   * = Fixed a Queue Limit bug
  18   * + Improved internal event handling code so uploadSuccess fires even when not content is returned from the server (*woot*, except for Macs)
  19   * = Fixed issues in Destroy
  20   * = Fixed issues with Queue Plugin
  21   * + Added periodic checks of the ExternalInterface
  22   * + Improved IE memory leak prevention code
  23   * + Added Speed Plugin
  24   * = Updated Queue Plugin for better multi-plugin compatibility
  25  
  26   * --------- Version 2.2.0 Beta 1-----------
  27   * + Added Flash Player 10 Support
  28   *   = Added setting for defining a button image
  29   *   = Added setting for defining button text
  30   *   = Added setting for defining button width, height and padding
  31   *   = Added setting for defining what element the Flash Movie should replace
  32   *   = Added setting for defining flash wmode
  33   *   = Added setting for defining the mouse cursor
  34   * + Added prevent_swf_caching setting as a work-around for issues in Avant Browser (and other IE based browser)
  35   * + Added setting for accepting HTTP Status codes other than 200 as successful
  36   * + Added parameter to cancelUpload that allows the uploadError event for cancelled uploads to be supressed
  37   * + Added pro-active memory leak fix for IE and fixed problems with the destroy function (credits to steffen for patches and testing)
  38   * + Replaced callFlash with CallFunction (using the internal function that Flash uses). Based on code from MooTools.
  39   * = Fixed bug in the Queue plugin that breaks startUpload when passing a file id.
  40   * + Updated Queue plugin to stop the queue if false is returned from the uploadStart handler.
  41   * = Fixed small issues in SWFObject plugin
  42   * = Fixed issue with ExternalInterface string escaping
  43   * - Dropped Graceful Degradation Plugin
  44   * - Dropped v1.0.2 Plugin
  45   * - Dropped Flash Player 8 support
  46  
  47   * --------- Version 2.1.0 -----------
  48   * = Fixed GET values so they are escaped properly
  49   * + Added destroy function
  50   * = Added exception handling around browse() calls
  51   * = Minor code cleanup
  52   * + Split Core and Demos
  53   
  54   * --------- Version 2.1.0 Beta 2-----------
  55   * = Fixed bug in XHTML fix where it wasn't split correctly by Flash
  56   * = Fixed file params "undefined" in debug output
  57   * + Added requeue_on_error settings so HTTP/IO/Security errors requeue the file instead of discarding it.
  58         This will affect the queue plugin (if an error is occurring the file will be reuploaded and reuploaded).
  59   * = Fixed HTTP/IO error behavior.  We'll see how this goes Flash 9 is supposed to call HTTPError followed by an IO error but I suspect they come out of orde sometimes.
  60   * = Fixed invalid characters in file param names.  Worked around flash bug by escaping the names. Should be transparent to devs.
  61   * = Fixed missing upload URL logic so it fires consistently
  62   * = Fixed file params not being sent when useQueryString is true
  63   * + Added SWFObject plugin and demo.
  64   * + Added CookieBug demo to demonstrate what they bug really is all about.
  65   * + Added VB.Net version of the Application Demo
  66   
  67   
  68   * --------- Version 2.1.0 Beta 1-----------
  69   * + Added allowScriptAccess="always" to the embed/object elements so the SWF can be served from different domains.
  70   * = Fixed a type-o in the debug output that prevented the instance id (movieName) from displaying. - Thx Joel
  71   * + Rewrote SWFUpload.js for better code reuse based on sample code from batiste.bieler (thanks!!!)
  72   * + Added queueComplete event to the Queue Plugin
  73   * + Added Simple Upload demo
  74   * = JSLinted all the JavaScript code
  75   * + Added use_query_string setting (and setUseQueryString function) that forces post_param and file_param values to be sent on the query_string instead of the post (for Flash 9 version)
  76   * = Fixed file.type and date properties so a default value is provided (rather than null) when no value is provided by flash.
  77   * = Fixed misc bugs in the demos
  78   * = Fixed ExternalInterface calls being made available for Flash 9 versions <9.0.28 which aren't supported
  79   * + Fixed use of & producing invalid XHTML in the <object> and <embed> tags.
  80   * - Removed the use of the embed tag (using the <object> sample from the Flash Satay method)
  81   * = Updated plugins to work with code rewrite changes.
  82   * = Extracted FileProgress object in to its own file.
  83   * + Added addPostParam and removePostParam functions
  84  
  85   * --------- Version 2.0.2 -----------
  86   * = Fixed a bug where post params could not be added to the current file (because it is removed from the queue when it becomes current)
  87   * = Fixed a conversion error when converting kilobytes to bytes in the file size check
  88   * = Fixed a problem in the documentation that said the file_size_limit was bytes when it is actually kilobytes
  89   * + Added formatting to the documentation, a table of contents, and details for each setting .
  90   * + Added units for file_size_limit setting. The setting understands B, KB, MB, GB. Default is KB.
  91   * + Added a check for the ExternalInterface functions in flashReady so SWFUpload will not fire the loaded event if those are not available.
  92    
  93   * --------- Version 2.0.1 -----------
  94   * = Fixed a bug where zero-byte files would stop file the queuing process.
  95   * = Finished updating Features Demo
  96   * + Added GetFileByIndex(i) that gets a JavaScript File Object.  The index never changes. Finished files continue to be available.
  97   *    The JavaScript GetFile function will accept a file_id or an index.
  98   * + Added CheckFileSize constants to replace the magic numbers
  99   * + Added some code in an attempt to fix "Script is running slowly" error messages
 100   * = Better cleanup of FileReference objects
 101   
 102   * --------- Version 2.0 -----------
 103   * + Re-created SWFUpload in Actionscript v2 for Flash 8 compatibility. Flash 8 loses POST and Server Data features.  The two versions are otherwise fully compatible.
 104   *    Flash 8 uses URL to pass post_params/file_params.
 105   * = Changed uploadStart event so it's part of the setTimeout/eventQueue workaround. This allows Flash functions to be called from uploadStart.
 106   * = Renamed uploadComplete to uploadSuccess and fileComplete to uploadComplete.  All started uploads call uploadComplete (even if cancelled or stopped).
 107   * = Changed startUpload validation failure behavior. Rather than cancelling the upload the file is now requeued. Devs can cancel
 108   *    or do whatever the need to in uploadError to handle the problem.
 109   * = Fixed fileQueueLimit/fileUploadLimit logic so it works correctly.
 110   * = Moved the upload request building to a later point so that the post params and file params can be updated in uploadStart.
 111   * - Removed the last of the UI stuff (ui_container, degraded_container).
 112   * + Started development on Plug-ins. Graceful Degradation, v1.0.2, Cookies, Queue Handling
 113   * = Fixed missing file_status field in FileItem.
 114   * + Added modificationDate to FileItem (file object)
 115   * + Added setStats function that lets you change the file upload count, etc.  This will give more power over the queue limits. Not well tested.
 116   * = Renamed compeleted_uploads to successful_uploads in getStats object
 117   * + Added in_progress to getStats object
 118  
 119   * --------- Revision 7.0 beta 3 -----------
 120   * + Added an "event queue".  Events are added to an array and executeEvent is called on a setTimeout. This prevents out of order issues that occur
 121   *    in the Safari browser.
 122   * + Added a check for the UPLOAD_COMPLETE_DATA event constant which only became available in Flash Player 9.0.28.  This 
 123   *    fixes the Flash Version detection (Flash Object Detection) which was accepting Flash Player 9 versions before 9.0.28.
 124   * - Removed old code block that was missed when moving from a Flash Timer to the JavaScript timeout (caused certain cancel events to be called twice)
 125   * = Change ShowUI to the swfUploadLoaded event which will hopefully make it more clear that this is an overrideable event
 126   * = Changed flashReady to behave like the other events (uses setTimeout and the Event Queue).
 127   
 128   * --------- Revision 7.0 beta 2 -----------
 129   * = Changed ERROR_CODE_FILE_NOT_FOUND to ERROR_CODE_FILE_ID_NOT_FOUND
 130   * + Grouped the error code constants in objects for queue errors and upload errors.
 131   * + Added an UPLOAD_STOPPED error code.
 132   * = Changed Event calling method (using Timer) in Flash.  Timer is no longer called
 133   *    instead setTimeout is called in JavaScript.  This includes a change to the
 134   *    JavaSCript design so the Event methods are not directly overridden but stored
 135   *    internally and called if defined (with a setTimeout).  This is an effort
 136   *    be more compatible with the current Flash Player on Linux
 137   * = Changed the parameter order for the fileQueueError and uploadError events so the fileObj is first, like other events.
 138   * + Added an empty JavaScript object (customSettings) where users can store settings associated with the instance.
 139   * + Worked around an escaping bug in the ExternalInterface library by escaping all backslashes in out-going strings.
 140   * = Updated all the demos.
 141   
 142   * --------- Revision 7.0 beta 1 -----------
 143   * = Redesigned the Event Chain
 144   * - Removed much of the queue concepts
 145   * - Removed the fileValidation events. This can be done in the new uploadStart event
 146   * - Removed beginUploadOnQueue feature. This can be done in the new dialogComplete event.
 147   * - Removed use_server_data. This is now always on.
 148   * + Added functions for retrieving queue stats (number of files uploaded, queued, errors, etc)
 149   * + Added a file status property to the FileObject. This indicates, uploaded, error, waiting.
 150   * + Added a single file browser (user cannot select multiple files)
 151   * + Fixed bug (hopefully) caused if Flash call to JavaScript and in the callback JavaSCript calls to Flash
 152   *    This only place this does not apply is to uploadStart.  If you call in to Flash from uploadStart use a setTimeout to do it.
 153  
 154   * --------- Revision 6.2 -----------
 155   * + Added API calls for changing all the changeable settings dynamically
 156   * = Fixed a bug in FileComplete event handler (in the SWF) that caused an error in Debug Players
 157   *     and prevent the event from being called
 158   * + Added a setting (use_server_data_event) to indicate whether FileComplete or ServerData should be called.
 159   *     The SWFUpload architecture requires that only one file upload success event can be called.
 160   * = Updated all the Demos, especially the Features Demo and the Forms Demo
 161  
 162  
 163   * --------- Revision 6 -----------
 164   * - Removed the call to setUploadSettings in flashReady.  This was a left over call that is unnecessary.
 165   * + Finished the parsing of post params during the init stage. This ommision was hidden by the call to setUploadSettings.
 166   * - Removed the flash_target_id setting.  The Flash file should only ever be added to the body tag.
 167   * + Fixed (hopefully for good) another SWF race condition.  IE executes the SWF very very early.  The this.movieElement value should never be referenced.
 168   *     The movie Element should always be retrieved using this.getMovieElement().
 169   
 170   * --------- Revision 6 -----------
 171   * + Ported to ActionScript 3.  Revision 6 requires Flash Player 9.
 172   * = Fixed bug caused when cancelling single files. Would break any function that searched for a file_id.
 173   * - Removed the automatic cookie sending setting. Devs should just pass the value they want to send in the post_params
 174   * - Removed the query params settings (global and file specific).  All params should be sent in the post_params
 175   * + Added post_params which adds post values to the file upload post.
 176   * + Added validate_files setting flag which causes the fileValidation event to be called before each file is uploaded.
 177   * + Added fileValidation event. Return false if validation fails and true if validation is successful.
 178   * + Added server_data parameter to the fileComplete event which returns any text that the upload script returns.
 179   * = Updated all demos to work with Revision 6
 180   * + Added in-code file extension validation.  Before a file is queued the extension is checked against the valid extensions.
 181   *     Files the have invalid extensions cause the error event to be raised.
 182   * + Added 'file_post_name' setting that allows the post variable name containing the file data to be named something other than 'Filedata'
 183   * = Fixed a race condition in loadFlash where a cached flash movie would execute before this.movieElement could be assigned and loading would fail.
 184  
 185   * --------- Revision 5.2 -----------
 186   * = A little more code cleaning and variable renaming
 187   * + Changed from an array queue to a FIFO queue. This eliminates the "current_index" and
 188   *    should reduce some memory usage.
 189   * + Added out of order file uploading.  Call StartUpload(/file_id/).
 190   * + Added custom query_string parameters in addition to the cookies
 191   * + Added the ability to modify the URL, cookies, params and send to flash
 192   * + Added per file query_string params
 193   * + Added files queued limit.  Sometimes you may want the user to only queue one file at a time (or something)
 194   * + Fixed limits so a zero(0) value means unlimited.
 195   
 196   * --------- Revision 5 -------------
 197   * = More code cleaning.  Ported SWF to FlashDevelop. (Since my Flash Studio trial expired)
 198   *    The port to FlashDevelop is a big deal.  It significantly changes the code structure
 199   *    and could introduce bugs.  Also there have been reported issues with the FlashDevelop
 200   *    version from swfupload.mammon.se: Doesn't start when reloading in IE.  Doesn't start
 201   *    in Firefox if the SWF file is visible because of a page scroll.
 202   *    + I fixed the Firefox issue by removing the wmode attribute from the embed object.
 203   *    + I cannot reproduce the IE issue on my local machine (although I can reproduce it at swfupload.mammon.se)
 204   * + Event Handlers are now attached to the SWFUpload javascript object.  The SWF file
 205   *    now calls the handlers in the context of the SWFUpload object which means the "this"
 206   *    object inside the handler refers to the proper SWFUpload instance.
 207   * + Tested and Fixed upload target cookie attachment
 208   * = Cleaned up / renamed everything for clarity and consistancy
 209   * + File queuing is now subject to the upload limit.  If the user attempts to queue more files
 210   *    than allowed an error is returned and the files are not queued.
 211   * + Fixed misc bugs and text encodings.
 212   * + Added more debug info for the SWF file.
 213   * + SWF file now obeys the debug setting.
 214   * + Added SetUploadTargetURL function that allows you to "dynamically" change the upload target
 215   * + Added error code for zero byte file uploads which always return an IO error. The files are now rejected
 216   *    instead of being uploaded.
 217   
 218   * --------- Revision 4 -------------
 219   * = Cleaned up code.  Added comments. Reorganized. Added more try..catches. Removed old unused methods.
 220   * - Removed the 'create_ui' setting.  The UI is now completely up to the developer.
 221   * + Added upload_backend_cookies setting. Can set a string, or array of cookie names. These values will be
 222   *    passed as part of the upload_backend url
 223   *
 224   * = Changed QueueComplete event to only fire if at least one file has been successfully uploaded.
 225   * + Added "Stop Upload" feature.
 226   * = Revised the FLA file to clean things up, better handle errors, etc.
 227   * = Fixed a bug where cancelling the first upload would cause the remaining uploads to fire before calling
 228   *    "startUpload". This change is in the FLA.
 229   *
 230   * + Fixed a bug in the upload.swf that prevented further file processing after an error is returned.
 231   * + Added uploadLimit variable.  Only complete uploads are counted. Once the limit is reached the flash
 232   *      movie will not upload any more files. (The ability to select or queue many files is not affected
 233   *      by the upload limit)
 234   * + Added cancelQueue and cancelUpload methods.
 235   * + Added ID property to the FileObj in the upload.swf
 236   * + Added Upload and Queue settings
 237   * + Added methods for generating the flash HTML and inserting it into the DOM.
 238   * - Removed SWFObject
 239   * + Updated the upload.swf and added the "flashReady" event.  This will only call back
 240   *        for Flash 8 and above.  With this we don't need a flash version detect script.
 241   *        The script initializes the Flash then waits for the Callback to init the UI.
 242   * + Added seperate ui_target, degraded_target, create_ui settings. This allows fine control
 243   *      over what parts of the GUI the script displays and hides
 244   *
 245   * + Changed from a Static Class to an Instance (changed code/class structure)
 246   * + Added "flash_version" setting.  When set to zero the version check is skipped
 247   * + Added Debug Console.  The Instance class can't do document.write.
 248   * = De-obfuscated SWFObject a bit
 249   * - Removed standalone mode.
 250   * + Added "ui_target" setting. When non-blank the link is added.
 251   * + Added "flash_target" setting.  When blank the flash is appended to the <body> tag
 252   *        = This fixes ASP.Net not allowing the flash to be added to the Form
 253   * + Added error checking to the callSWF method
 254   *
 255  
 256  
 257   * -------- -------- -------- -------- -------- -------- -------- --------
 258   * SWFUpload 0.7: Flash upload dialog - http://profandesign.se/swfupload/
 259   * SWFUpload is (c) 2006 Lars Huring, Olov Nilzén and Mammon Media and is released under the MIT License:
 260   * http://www.opensource.org/licenses/mit-license.php
 261   * -------- -------- -------- -------- -------- -------- -------- --------
 262  
 263   * SWFUpload 0.7: Flash upload dialog - http://profandesign.se/swfupload/
 264   *
 265   * VERSION HISTORY
 266   * 0.5 - First release
 267   *
 268   * 0.6 - 2006-11-24
 269   * - Got rid of flash overlay
 270   * - SWF size reduced to 840b
 271   * - CSS-only styling of button
 272   * - Add upload to links etc.
 273   *
 274   * 0.7 - 2006-11-27
 275   * - Added filesize param and check in SWF
 276   *
 277   * 0.7.1 - 2006-12-01
 278   * - Added link_mode param for standalone links
 279   * if set to "standalone", createElement("a") won't run.
 280   * - Added link_text param if css isn't needed.
 281   * - Renamed cssClass to css_class for consistency
 282   *
 283   */